home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / EMULATOR / OLD / CPCEM102.ZIP / !CPCEmu / !Help < prev    next >
Text File  |  1996-09-12  |  10KB  |  259 lines
  1. ————————————————————————————————————————————————————————————————————————————————
  2. CPC-Emulator V1.02 / 12-09-96
  3. programmed in 1994-1996 by Andreas Stroiczek
  4. (AMSDOS-ROM & system-ROM are copyright by AMSTRAD)
  5. (BASIC-ROMs are copyright by LOCOMOTIVE SOFTWARE)
  6. ————————————————————————————————————————————————————————————————————————————————
  7.  
  8. !CPCEmu is freeware. That means, if you love it feel free to send me some gifts
  9. or money for it, for moral support... :)
  10.  
  11.  
  12. Introduction
  13. ~~~~~~~~~~~~
  14. This program emulates an AMSTRAD CPC (Colour Personal Computer). It's a
  15. Z80/4MHz-based 8-bit-computer with high resolution colour-graphix and
  16. disk-drive.
  17.  
  18. If you don't know this machine try this:
  19. ⇨ start the emulator
  20. ⇨ 'insert' a disk-image in drive A
  21. ⇨ type CAT to get the directory
  22. ⇨ to start some programs just type RUN"program.xyz"
  23.  
  24.  
  25. Features
  26. ~~~~~~~~
  27. • fast Z80-emulation
  28. • real CRTC-emulation (!) (for splittings and fullscreen)
  29. • up to 128k RAM
  30. • 8 UPPER-ROMs (ROM 7 must be AMSDOS-ROM, ROM 0 is the BASIC-ROM)
  31. • disk-emulation provides two drives and different formats
  32. • sound-support incuding hardware-envelopes and sample-replay
  33.  
  34.  
  35.  
  36. a small history:
  37. ~~~~~~~~~~~~~~~~
  38.  
  39. Changes from version 0.79 to 1.02
  40. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  41. • fixed some bugs in Z80-emulation
  42. • logarithmic sound-output
  43. • horizontal colour-splitting
  44. • direct .DSK-support
  45. • option to change the ROM-internal key-mapping (for german and uk keyboards)
  46. • loading disk-images via drag'n'drop
  47. • multitasking (most work)
  48. • 16 colour mode (uses Mode 35)
  49. • Mode 35 modules and new Mode 36 modules for the Archimedes by Nicolai Willers
  50.   (big thanx!!)
  51. • joystick support
  52. • DiskImages filetyped (&064="CPC snap", &065="CPC disc")
  53. • sampled sound support (fast machine recommended to prevent noisy samples)
  54. • PIO-error fixed (thanx to Brice Rive and his netnews-discussion)
  55. • after all changes to the sound-system: PSG-module rewritten!
  56. • Printerport-/Digiblaster-emulation
  57. • HALT-Bugfix!
  58.  
  59. Changes from version 0.50 to 0.79
  60. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  61. • faster Z80-emulation
  62. • interrupt and Gate Array bug fix
  63. • drive B is now installed (drive and head select works now)
  64. • !CPCEmu loads and makes snapshots
  65. • faster CRTC-emulation
  66. • easy file-exchange between AMSDOS and RISC OS via !Extractor
  67. • modules for Mode 36 for the Archimedes taken from Coder's Revenge
  68.   (thanx to Mr.Hill and Frisco of Archiologics)
  69. • border-redraw bugfix
  70. • and finally SOUND!!!
  71.  
  72.  
  73.  
  74. what's still to do?
  75. ~~~~~~~~~~~~~~~~~~~
  76. - make better CRTC/timing/colour-splitting
  77. - emulate CRTC-register 5
  78. - FDC-routines are still not completed
  79. - rewriting !CPCXtract to make use of the FDC-module
  80. - add EDSK-support
  81.  
  82. ————————————————————————————————————————————————————————————————————————————————
  83.  
  84.  
  85. Mouse & Keys
  86. ~~~~~~~~~~~~
  87. In fullscreen-mode you have a menu at the top of the screen. You can use
  88. the menu-button of your mouse to switch the menu on/off. You can get the
  89. list of DiskImages by pressing the menu-button while your pointer is on
  90. "DriveA{side0}{--}". You may also change the options (side-selection and
  91. write-protection) with select- and adjust-button.
  92.  
  93. If you don't wanna use your mouse, you may use following keys:
  94.         <F1>: insert a disk-image in drive A
  95.  <SHIFT><F1>: turn disk in drive A     (also in multitasking-mode)
  96.   <CTRL><F1>: protect/deprotect disk in drive A
  97.         <F2>: insert a disk-image in drive B
  98.  <SHIFT><F2>: turn disk in drive B     (also in multitasking-mode)
  99.  <SHIFT><F3>: sound on/off
  100.   <CTRL><F2>: protect/deprotect disk in drive B
  101.  <SHIFT><F4>: make screen-shots        (you'll find them in !CPCEmu.screenShot)
  102.  <SHIFT><F5>: make snap-shots          (you'll find them in !CPCEmu.snapShot)
  103.  <SHIFT><F8>: reset                    (also in multitasking-mode)
  104.  <CTRL><F10>: quit
  105.  
  106.  
  107. You can switch on a Joystick-emulation with NumLock.
  108. With Joystick-emulation ON (=NumLock OFF), the emulator uses following keys
  109. for the stick:
  110.  
  111.   right Ctrl: fire 2  (this is the main joystick-button)
  112.    right Alt: fire 1
  113. on keypad: 1: left
  114.            2: down
  115.            3: right
  116.            5: up
  117.  
  118. For more information about the CPC & CPC-Emulator-keyboard see the Draw-file
  119. "KeyInfo" in !CPCEmu.Keys.
  120.  
  121. Since version 1.02 there is an option to change the ROM-internal
  122. key-translation. This patch fits to german and uk keyboards.
  123. To get the characters {[]}|@~ on german keyboards use the CTRL instead of ALT
  124. ('cause the CPC don't know any ALT-keys...).
  125.  
  126.  
  127.  
  128. Multitasking
  129. ~~~~~~~~~~~~
  130. Note: since version 1.02 it is possible to change the setup while CPC is
  131.       running. When changing ROM-configuration or CPC-type, the CPC will crash.
  132.       You have to make a CPC-hard-reset afterwards.
  133.  
  134. In multitasking-mode you have the following shortcuts:
  135.  <SHIFT><F1>: turn disk in drive A
  136.  <SHIFT><F2>: turn disk in drive B
  137.  <SHIFT><F8>: reset
  138.  
  139.  
  140. special mouse-clicks:
  141.  
  142. click with right mousebutton:
  143. on emulatorwindow           ⇨ deselect and freeze emulator
  144. on iconbar                  ⇨ singletask
  145. on panewindow/diskselection ⇨ open default DISKs-directory (!CPCEmu.DISKs.)
  146.  
  147. double-click:
  148. on emulator-window          ⇨ singletask
  149.  
  150. click with left mousebutton:
  151. on %-display                ⇨ switch between max.100% and max.speed
  152.                               (does also work in singletasking-mode)
  153.  
  154.                                     
  155.  
  156. How to get DiskImages from your old CPC
  157. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  158. Use !CPCXtract to copy Files onto DiskImages. You can get those file via
  159. PC-DOS-disk, you'll need a 3.5"-disk-drive connected to your old CPC for it and
  160. a CPC-program which is capable to copy files onto a PC-disk (like DOSCOPY).
  161. Then you can use !CPCXtract on your Acorn.
  162. !CPCXtract also contains a DSK-filter.
  163.  
  164. Another way is to connect the CPC with your Acorn-Computer via parallel-port
  165. as following:  (ATTENTION: THIS DOESN'T WORK VERY WELL!!)
  166.  
  167. CPC            Acorn
  168.  2   D0          2   D0
  169.  3   D1          3   D1
  170.  4   D2          4   D2
  171.  5   D3          5   D3
  172.  6   D4          6   D4
  173.  7   D5          7   D5
  174.  8   D6          8   D6
  175.  9   GND     18-25   GND
  176.  
  177. You'll find the CPC-tranfer-program in !CPCEmu.!CPCTrans.CPC. You have to
  178. transfer this CPC-program to your CPC.
  179. After everything is connected you should start !CPCTrans first(!) and after that
  180. start the CPC-pendant ARCTRANS.BAS on your CPC.
  181. The default-parameters of ARCTRANS.BAS are 42 Tracks, DATA-format (&C1-&C9),
  182. 512 byte sector-size (2) and soure-drive B (1). You have to change this if
  183. necessary (i.e. take &41/&49 for first sector/last sector if you want to
  184. transfer a disk formatted with SYSTEM-format).
  185.  
  186. If the transfer is completed successfully you'll find the generated DiskImage
  187. in !CPCEmu.!CPCTrans named "newDisk". To use this image-file just copy it into
  188. !CPCEmu.DISKs .
  189. Note: The transfer works well on my Risc PC. Maybe it won't work correctly on
  190.       slower machines. You may set the variable "transferRate" in ARCTRANS.BAS
  191.       to a higher value than 92 if your machine responses with checksum-errors.
  192.  
  193.  
  194.  
  195. DiskImage specification
  196. ~~~~~~~~~~~~~~~~~~~~~~~
  197. First, there is a 128 byte header. You may change the number of tracks, but the
  198. size of the DiskImage has to be  128 + 2 * 6144 * <number of tracks>.
  199.  
  200. 43 50 43 2D 45 6D 75 6C 61 74 6F 72 30 2E 35 30     CPC-Emulator0.50
  201. 44 69 73 6B 49 6D 61 67 65 56 34 00 00 00 00 00     DiskImageV4.....
  202. 34 30 54 72 61 63 6B 73 00 00 00 00 00 00 00 00     40Tracks........
  203. 44 6F 75 62 6C 65 53 69 64 65 64 00 00 00 00 00     DoubleSided.....
  204. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00     ................
  205. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00     ................
  206. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00     ................
  207. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00     ................
  208.  
  209. This is followed by the tracks. Each track is 2 * 6144 bytes long, 6144 bytes
  210. for side 0 and 6144 bytes for side 1 of the CPC-disk.
  211.  
  212. One side of a track looks like following datas:
  213.  
  214. Track start (one side, 6144 bytes):
  215.  
  216. 49 4E 44 58 49 44 46 44 00 00 C1 02 00 00 00 00     INDXIDFD........
  217. 00 00 00 00 00 00 00 00 ⇧  ⇧  ⇧  ⇧  44 41 54 41     ⇧...⇧...⇧...DATA
  218. 00 45 58 .. .. ..       ¦  ¦  ¦  ¦                  ¦   ¦   ¦   ⇧
  219.                         ¦  ¦  ¦  size 2 (512 bytes) ¦   ¦   ¦   ¦
  220.                         ¦  ¦  sector &C1            ¦   ¦   ¦   data-word
  221.                         ¦  head 0                   ¦   ¦   ID-field data
  222.                         track 0                     ¦   ID-field-word
  223.                                                     index-word
  224.  
  225. The track starts with the "INDX"-mark followed by "IDFD" followed by the ID-data
  226. for the first sector on track (4 byte ID-field + 16 reserved bytes) followed by
  227. the "DATA"-mark followed by the sector-datas (i.e. 512 bytes). After that the
  228. next sector on track starts exactly like the first one. The only difference is
  229. that it starts up with four 00-bytes instead of the "INDX"-mark. The rest of
  230. this track is set to 00.
  231.  
  232.  
  233.  
  234. ————————————————————————————————————————————————————————————————————————————————
  235. Send your improvements & suggestions to:
  236.  
  237.  Andreas Stroiczek
  238.  Zum Kindergarten 5
  239.  32427 Minden
  240.  Germany
  241.  
  242. (email:hugger@azrael.uni-paderborn.de)
  243.  
  244. (does anybody need more than 8 upper ROMs and/or 128k RAM for the emulator???)
  245. ————————————————————————————————————————————————————————————————————————————————
  246. special greetinx to
  247.                          Patrick Hinrichs
  248.                            Eduard Pfarr
  249.                            Boris Leppin
  250.                             Mark Rison
  251.                            K.E.W.Tacker
  252.                          Ronald Heitmann
  253.                       Ingo & Nicolai Willers
  254.                           Thomas Boroske
  255.                           Reiner Lorenz
  256.                            Oliver Mayer
  257.                             Jörn Mika
  258. ————————————————————————————————————————————————————————————————————————————————
  259.